home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_1
/
ck3012.zip
/
CARDKING.DOC
< prev
next >
Wrap
Text File
|
1990-11-01
|
13KB
|
302 lines
Card Kingdom
**************
Multi-Node
Version 3.0
Release Date 11-01-90
A Blue Foxx Live Door
Production
Written By:
Tim Maloney
P.O. Box 230
Altus, Ok, 73521
The Blue Foxx BBS
(405) 482-3855
300/1200/2400 24 hrs
Regardless of how you recieved this product it is provided "AS-IS" without
any warranty or guarantee. You the end user accept full responsibilty for
using this product. By using this product you do so solely at your own risk.
You agree to hold the author free from any responsibility regarding loss of
profits, system damage (software or Hardware) or any other incidental,
special or unmentioned damages resulting from the use or inability to use
this end product.
This product is being distributed under the SHAREWARE concept. You may use it
for a period of time. After this time period you must either register the
product for your own use or discontinue using it. All Blue Foxx products
carry a Date stamp and after a certain period of time the SHAREWARE versions
will no longer function! Registered versions are registered to one individual
only and soley to that individual for use on that individuals own system.
Registered versions will contain an extra file with special information
pertaining to registered users. The registered versions MAY NOT be
distributed by anyone other than the author of this product. SHAREWARE
(UNREGISTERED) versions may be distributed freely by any BBS as long as no
fee is charged for this particular product and this product is not included
with any other product when distributed. The product must not be modified in
any way, shape or form without the written permission of the author!
Now that thats taken care of lets get down to the good stuff!!
This Door is a Production of Blue Foxx Software. At some later date in
time it will cease to operate. The time frame may be from already expired
to 3 months or less, depending on when you received this door. This is what
is known as a cripple door, honesty has always been the best policy but
sometimes a small reminder never hurt. I would have liked to distribute
these doors as open as possible but it seems that some people would like
to test the doors for a period that went into years. If these doors had
a warranty period it would have been up long ago. Anyways I have begun
distributing these doors like this so that everyone will have a some time to
determine if it is what they want or not. Also Registered Version may or may
not have extra or enhanced options for players or Sysops.
If you have any ideas on improving this or any other door that I have wrote,
please feel free to tell me. I'm always looking for suggestions, good or bad.
See the end of this DOC on how to register:
Now on to the good stuff:
All major changes will be marked <NEW>. These should be read as they
may contain information that if not included properly may cause the
door not to operate.
Any other changes were considered to minor to document or place within
this documentation.
The following files should be included in this package:
CK*.EXE Main game program
CARDKING.INS The instructions file (In Ascii) for players.
CARDKING.CFG A quick file to get it up in local mode fast.
Please rename any config file that you use to
CARDKING.CFG or the door may not run properly
in LOCAL mode only. (See instructions below)
LOCAL IS DEFINED AS FROM DOS. If you enter it
while logged on LOCALLY to your BBS it will work
with ANY config filename.
CHECKNEW.EXE If this file is present it would allow you to update
a previously running version to this version if necessary.
FILE YOU MUST SUPPLY:
BRUN45.EXE This must be a patched copy and must be in your PATH
(Any patched copy will do, and this file is no longer
included in the door program. If you don't have a copy
it is on many BBS' already and you may call mine and
download it anytime if you need it.
SFDOORS.DAT Supplied by your BBS. Or the door monitor that you use
to run doors for other BBS systems.
I suggest you rename the main file to CARDKING.EXE This will help you
to keep track of the associated programs and also make it easier if you
add a newer version. You will not have to change your BAT/Monitor files
in the future, if you start off with a name such as this. All other files
MUST NOT BE RENAMED or an error may result.
THESE FILE MUST NOT BE DELETED OR THE GAME WILL NOT RUN LOCAL OR OTHERWISE!
IF ANY OF THESE FILES IS ACCIDENTLY DESTROYED THE FOLLOWING SHOULD HELP YOU
TO REBUILD THEM.
Files created as the door needs them:
CARDKING.PLY The Players statistics file. This is now created if
it does not already exist.
*.DAY Created each new day to keep track of how many times a
player can play each day. This file is not created if
you have set the amount of times a user can play to "U"
in the *.CFG file.
*.BAD Created when a caller drops carrier in the door. This is
to let the Sysop know who may have had a problem in the
door and the Sysop can then ask them about it.
It has been suggested to have this go to the HEYSYSOP.LOG
or the CALLERS.LOG. If you would like to vote on this please
let me know. Reason being this door supports different BBS
types and making them all compatable can be a chore.
*.ERR Created whenever an ERROR results in the door. This will NOT
be created if the door is not properly set up. Most of the
ERROR numbers generated can be found in your DOS BASIC
reference manual. If you get one that you cannot identify
please feel free to leave me a message.
STEP 1:
THE CONFIG FILE
Your config file should contain the folowing:
UNREGISTERED Place Your Registration number here
BBSTYPE Either SPITFIRE, QBBS or WILDCAT
BBSNAME The Name of YOUR BBS
SYSOPFIRST The Sysops First Name
SYSOPLAST The Sysops Last Name
c:\xxx\doorinfo.xxx PATH AND NAME to either CALLINFO.BBS OR SFDOORS.DAT
60 Time a user can be in the door (subject to time left)
c:\xxx\xxx\color.bul PATH AND NAME for the Color Bulletin
c:\xxx\xxx\mono.bul PATH AND NAME for the Mono Bulletin
U Number of times a user can enter the door each day.
U is unlimited times
Change the U to a 1,2,3 etc to limit number of plays
The game will sense if you lock DTE and take appropriate steps to insure that
proper locking takes place. The door has only been tested to 19,200 baud and
only on comm ports 1 and 2.
I suggest you rename the config file after the *.DAT file
Ex... CARDKING.CFG
This will allow you to keep better track of the related files, and allow
quick entry when entering from LOCAL mode.
For other nodes I suggest CARD2.CFG for node 2, CARD3.CFG for 3 etc..
STEP 2:
DATA FILES:
Just copy all of the above files into the directory that you wish to
run the door from.
Layout for the *.INS file:
This is a strickly ASCII TEXT file with nothing special in it!
The door itself manages the instructions file and if you see
anything that should be added you can simply use an ASCII text
editor.
Layout for the *.PLY file:
## <=- Number of Players (not including Champs)
Top Champ , Score , Date <=- Name of Top Champ a comma Top Score comma
and a date 10-01-89
Last Champ, Score , Date <=- Name of Last Champ a comma Last Score comma
and a date 10-01-89
Player 1, Score, Date, 0, 0, 0, 0, 0, 0
| | | | | | | | |
| | | | | | | | ## Of Knights Player Has
| | | | | | | |
| | | | | | | ## Of Guards Hired
| | | | | | Gambler Cash
| | | | | Gambler (0 or 1)
| | | | Bandit Cash Stolen
| | | ## Bandits Hired
| | Last Date Played
| The Players Score
The Players Name
This file now creates itself. This information is
provided for the Sysop who may need it.
BRUN45.EXE must be in your path somewhere. Also it must be patched for
DTR or the door may drop carrier on the caller when entering. It will
work fine locally but not remote. Any patched copy will usually do and
if it is in your path then you will only need ONE copy anywhere on your
drives!!
STEP 3:
STARTING THE GAME:
This is the easiest part.
A. LOCAL:
Just type the name of the game and it will do the rest.
In Local mode the door will load the CARDKING.CFG file
automatically. Please be sure you have named it CARDKING.CFG
or the door will not function properly in local mode.
The Sysops name will be taken from this file for use in
the game. Future releases of this door may or may not
utilize this as a way of identifying the Sysop!
ex. CARDKING local or CARDKING
B. AS A DOOR:
First you must Change Directory (CD or CHDIR) into
the directory containing the door. Then type the name of the
door ,a space, and the name of your config file.
ex. CD \DOOR
CARDKING CARDKING.CFG
remember to change back to your calling directory with a CD
on the line following the one that calls the door.
MULTI-NODE OPERATION:
You must have a seperate CFG file for each Node that you wish
to put this door on. Only one EXE file is necessary and starting
the door would be as follows for each door.
ex. CD\DOOR
CARDKING CARD2.CFG <=- Node 2
CD\DOOR
CARDKING CARD3.CFG <=- Node 3 etc
Most Sysops will already be familiar with their BBS Doors and
will only have to add the above lines into whatever batch file
of door monitor file that will eventually call the door.
EXAMPLE BATCH FILE TO CALL THIS DOOR:
ECHO OFF
E:
CD E:\SF\DOORGAME
{exefilename} {configfilename}
CD E:\SF
And there you have it.. If I have left anything out or if you have any
suggestions for this or future doors....
Give me a call at The Blue Foxx BBS (405) 482-3855 (300/1200/2400 24hrs)
If you would like to register this program:
Send $10 And the Name Of The Door you wish to register.
To:
Tim Maloney
Blue Foxx BBS
P.O. Box 230
Altus OK, 73521
Please Include the NAME you wish to Place on Your Registered
Version. Preferably this is the Sysops First and Last Name.
Your Registered Copy will Be available For immediate Download From
the Blue Foxx BBS. If you wish to be pre-registered on the Blue Foxx please
include the folowing with your registration:
First and Last Name you will use. (No Aliases)
Password
Birthdate
Mailing Address
City, State & ZIP Code
This does not have to be fancy.. Just tear off any old piece of paper and
write clear enough to read and mail it off.
If you wish just use the ole Print Screen routine here and fill in the
blanks.. Thats what I see most anyways..
CARD KINGDOM $10-----
NAME (First and Last) __________________________________
Voice Phone Number _____________________________________
Password (if not already logged on) ____________________
In either Case if you have any suggestions feel free to call and leave
me a comment.
*********************************** END OF DOC ****************************